# Руководство по оформлению Markdown файлов
Markdown - это облегчённый язык разметки, который преобразует текст в структурированный HTML. Следующее руководство поможет вам разобраться, как использовать Markdown.

## Заголовки
```
# Заголовок первого уровня
## Заголовок второго уровня
### Заголовок третьего уровня
#### Заголовок четвёртого уровня
##### Заголовок пятого уровня
###### Заголовок шестого уровня
```
***Пример:***

# Заголовок первого уровня
## Заголовок второго уровня
### Заголовок третьего уровня
#### Заголовок четвёртого уровня
##### Заголовок пятого уровня
###### Заголовок шестого уровня
---

## Параграфы и переносы строк
```
Это параграф. Чтобы создать новый параграф, оставьте пустую строку между двумя строками текста.

Это первая строка  
И это вторая строка, но они находятся в одном параграфе. Для переноса строки используйте два пробела в конце предыдущей строки.
```
***Пример:***

Это параграф. Чтобы создать новый параграф, оставьте пустую строку между двумя строками текста.

Это первая строка  
И это вторая строка, но они находятся в одном параграфе. Для переноса строки используйте два пробела в конце предыдущей строки.

---

## Выделение текста
```
*курсив*  
_курсив_

**жирный**  
__жирный__

***жирный курсив***  
___жирный курсив___

~~зачеркнутый~~
```
***Пример:***

*курсив*  
_курсив_

**жирный**  
__жирный__

***жирный курсив***  
___жирный курсив___

~~зачеркнутый~~

---

## Списки
### Нумерованный список
```
1. Пункт первый
2. Пункт второй
3. Пункт третий
```
***Пример:***

1. Пункт первый
2. Пункт второй
3. Пункт третий
---

### Маркированный список
```
- Пункт первый
- Пункт второй
- Пункт третий
```
***Пример:***

- Пункт первый
- Пункт второй
- Пункт третий
---
### Вложенные списки
Также можно делать вложенные списки, добавляя 4 пробела перед пунктом:
```
1. Пункт первый
    - Подпункт первый
    - Подпункт второй
2. Пункт второй
```
***Пример:***

1. Пункт первый
    - Подпункт первый
    - Подпункт второй
2. Пункт второй
---

## Ссылки
```
[Текст ссылки](https://www.example.com)
```
***Пример:***

[Текст ссылки](https://www.example.com)

---

## Изображения
```
![Текст описания](https://www.example.com/image.jpg)
```
***Пример:***

![Текст описания](https://assets.simpleviewinc.com/simpleview/image/upload/c_fill,h_720,q_75,w_1400/v1/clients/newyorkcity/Coronavirus_Info_midtown_manhattan_skyline_nyc_3000x2000_364fa9b8-86ce-4f95-907a-4bd8ea32f232.jpg)

---

## Блоки кода
### Строка кода
```
`строка кода`
```
***Пример:***

`строка кода`

---
### Блок кода

Удалите символы `\`
```
\```
Блок кода
\```
```
***Пример:***

```
Блок кода
```

---
### Подсветка кода
Для блоков кода можно указывать язык программирования.

Используется подсветка синтаксиса из библиотеки `linguist`, которая включает множество различных языков.

Удалите символы `\`
```
\```python
print("Привет, мир!")
\```
```
***Пример:***

```python
print("Привет, мир!")
```

---

## Цитаты
```
> Первый уровень цитирования
>> Второй уровень цитирования
>>> Третий уровень цитирования
```
***Пример:***

> Первый уровень цитирования
>> Второй уровень цитирования
>>> Третий уровень цитирования

---

## Горизонтальная линия
```
---
```
***Пример:***

---

---

## Таблицы
```
| Заголовок 1 | Заголовок 2 |
| ----------- | ----------- |
| Ячейка 1    | Ячейка 2   |
| Ячейка 3    | Ячейка 4   |
```
***Пример:***

| Заголовок 1 | Заголовок 2 |
| ----------- | ----------- |
| Ячейка 1    | Ячейка 2   |
| Ячейка 3    | Ячейка 4   |

---

### Таблица как HTML
```
<table>
    <tr>
        <th>Заголовок 1</th>
        <th>Заголовок 2</th>
    </tr>
    <tr>
        <td>Ячейка 1.1</td>
        <td>Ячейка 2.1</td>
    </tr>
    <tr>
        <td>Ячейка 1.2</td>
        <td>Ячейка 2.2</td>
    </tr>
</table>
```
***Пример:***

<table>
    <tr>
        <th>Заголовок 1</th>
        <th>Заголовок 2</th>
    </tr>
    <tr>
        <td>Ячейка 1.1</td>
        <td>Ячейка 2.1</td>
    </tr>
    <tr>
        <td>Ячейка 1.2</td>
        <td>Ячейка 2.2</td>
    </tr>
</table>

---

## Чек-листы
```
- [x] Задача 1
- [ ] Задача 2
- [ ] Задача 3
```
***Пример:***

- [x] Задача 1
- [ ] Задача 2
- [ ] Задача 3

---

## Внутренние ссылки
```
[Перейти к Заголовку 1](#title1)

## <a id="title1">Заголовок 1</a>
Какой-то контент
```
***Пример:***

[Перейти к Заголовку 1](#title1)

## <a id="title1">Заголовок 1</a>
Какой-то контент

---

### Ссылка на заголовок на английском
```
[Some title 1](#some-title-1)

## Some Title 1
Some content
```
***Пример:***

[Some title 1](#some-title-1)

## Some Title 1
Some content

---

## Автоматические ссылки
```
<http://example.com/>

<address@example.com>
```
***Пример***

<http://example.com/>

<address@example.com>

---

## HTML
Markdown поддерживает использование прямого HTML внутри документа, так что вы можете использовать любые HTML-теги для более сложного оформления:
```
<kbd>CTRL</kbd> + <kbd>P</kbd>
```
***Пример:***

<kbd>CTRL</kbd> + <kbd>P</kbd>

---

## HTML-коды
Например, вы можете использовать HTML-код `&macr;` для добавления черты над буквой:
```
A&macr;
```
***Пример:***

A&macr;

---

## Комментарии
Вы можете вставить комментарии в свой markdown-файл, которые не будут отображаться в окончательном отформатированном виде:
```
[//]: # (Это комментарий, он не будет отображаться)
```
***Пример:***

[//]: # (Это комментарий, он не будет отображаться)

---

## Эмодзи (Github)
Вы можете использовать эмодзи в своих Markdown-файлах. [Существует множество эмодзи](https://gist.github.com/rxaviers/7360908), которые вы можете использовать, вот некоторые из них:
```
:smile:
:laughing:
:blush:
```
***Пример:***

:smile:
:laughing:
:blush:

---